home *** CD-ROM | disk | FTP | other *** search
/ Chip 2007 January, February, March & April / Chip-Cover-CD-2007-02.iso / Pakiet bezpieczenstwa / mini Pentoo LiveCD 2006.1 / mpentoo-2006.1.iso / livecd.squashfs / usr / lib / python2.4 / email / base64MIME.pyc (.txt) < prev    next >
Python Compiled Bytecode  |  2005-10-18  |  5KB  |  150 lines
  1. # Source Generated with Decompyle++
  2. # File: in.pyc (Python 2.4)
  3.  
  4. """Base64 content transfer encoding per RFCs 2045-2047.
  5.  
  6. This module handles the content transfer encoding method defined in RFC 2045
  7. to encode arbitrary 8-bit data using the three 8-bit bytes in four 7-bit
  8. characters encoding known as Base64.
  9.  
  10. It is used in the MIME standards for email to attach images, audio, and text
  11. using some 8-bit character sets to messages.
  12.  
  13. This module provides an interface to encode and decode both headers and bodies
  14. with Base64 encoding.
  15.  
  16. RFC 2045 defines a method for including character set information in an
  17. `encoded-word' in a header.  This method is commonly used for 8-bit real names
  18. in To:, From:, Cc:, etc. fields, as well as Subject: lines.
  19.  
  20. This module does not do the line wrapping or end-of-line character conversion
  21. necessary for proper internationalized headers; it only does dumb encoding and
  22. decoding.  To deal with the various line wrapping issues, use the email.Header
  23. module.
  24. """
  25. import re
  26. from binascii import b2a_base64, a2b_base64
  27. from email.Utils import fix_eols
  28. CRLF = '\r\n'
  29. NL = '\n'
  30. EMPTYSTRING = ''
  31. MISC_LEN = 7
  32.  
  33. def base64_len(s):
  34.     '''Return the length of s when it is encoded with base64.'''
  35.     (groups_of_3, leftover) = divmod(len(s), 3)
  36.     n = groups_of_3 * 4
  37.     if leftover:
  38.         n += 4
  39.     
  40.     return n
  41.  
  42.  
  43. def header_encode(header, charset = 'iso-8859-1', keep_eols = False, maxlinelen = 76, eol = NL):
  44.     '''Encode a single header line with Base64 encoding in a given charset.
  45.  
  46.     Defined in RFC 2045, this Base64 encoding is identical to normal Base64
  47.     encoding, except that each line must be intelligently wrapped (respecting
  48.     the Base64 encoding), and subsequent lines must start with a space.
  49.  
  50.     charset names the character set to use to encode the header.  It defaults
  51.     to iso-8859-1.
  52.  
  53.     End-of-line characters (\\r, \\n, \\r\\n) will be automatically converted
  54.     to the canonical email line separator \\r\\n unless the keep_eols
  55.     parameter is True (the default is False).
  56.  
  57.     Each line of the header will be terminated in the value of eol, which
  58.     defaults to "\\n".  Set this to "\\r\\n" if you are using the result of
  59.     this function directly in email.
  60.  
  61.     The resulting string will be in the form:
  62.  
  63.     "=?charset?b?WW/5ciBtYXp66XLrIHf8eiBhIGhhbXBzdGHuciBBIFlv+XIgbWF6euly?=\\n
  64.       =?charset?b?6yB3/HogYSBoYW1wc3Rh7nIgQkMgWW/5ciBtYXp66XLrIHf8eiBhIGhh?="
  65.  
  66.     with each line wrapped at, at most, maxlinelen characters (defaults to 76
  67.     characters).
  68.     '''
  69.     if not header:
  70.         return header
  71.     
  72.     if not keep_eols:
  73.         header = fix_eols(header)
  74.     
  75.     base64ed = []
  76.     max_encoded = maxlinelen - len(charset) - MISC_LEN
  77.     max_unencoded = max_encoded * 3 // 4
  78.     for i in range(0, len(header), max_unencoded):
  79.         base64ed.append(b2a_base64(header[i:i + max_unencoded]))
  80.     
  81.     lines = []
  82.     for line in base64ed:
  83.         if line.endswith(NL):
  84.             line = line[:-1]
  85.         
  86.         lines.append('=?%s?b?%s?=' % (charset, line))
  87.     
  88.     joiner = eol + ' '
  89.     return joiner.join(lines)
  90.  
  91.  
  92. def encode(s, binary = True, maxlinelen = 76, eol = NL):
  93.     '''Encode a string with base64.
  94.  
  95.     Each line will be wrapped at, at most, maxlinelen characters (defaults to
  96.     76 characters).
  97.  
  98.     If binary is False, end-of-line characters will be converted to the
  99.     canonical email end-of-line sequence \\r\\n.  Otherwise they will be left
  100.     verbatim (this is the default).
  101.  
  102.     Each line of encoded text will end with eol, which defaults to "\\n".  Set
  103.     this to "\r
  104. " if you will be using the result of this function directly
  105.     in an email.
  106.     '''
  107.     if not s:
  108.         return s
  109.     
  110.     if not binary:
  111.         s = fix_eols(s)
  112.     
  113.     encvec = []
  114.     max_unencoded = maxlinelen * 3 // 4
  115.     for i in range(0, len(s), max_unencoded):
  116.         enc = b2a_base64(s[i:i + max_unencoded])
  117.         if enc.endswith(NL) and eol != NL:
  118.             enc = enc[:-1] + eol
  119.         
  120.         encvec.append(enc)
  121.     
  122.     return EMPTYSTRING.join(encvec)
  123.  
  124. body_encode = encode
  125. encodestring = encode
  126.  
  127. def decode(s, convert_eols = None):
  128.     '''Decode a raw base64 string.
  129.  
  130.     If convert_eols is set to a string value, all canonical email linefeeds,
  131.     e.g. "\\r\\n", in the decoded text will be converted to the value of
  132.     convert_eols.  os.linesep is a good choice for convert_eols if you are
  133.     decoding a text attachment.
  134.  
  135.     This function does not parse a full MIME header value encoded with
  136.     base64 (like =?iso-8895-1?b?bmloISBuaWgh?=) -- please use the high
  137.     level email.Header class for that functionality.
  138.     '''
  139.     if not s:
  140.         return s
  141.     
  142.     dec = a2b_base64(s)
  143.     if convert_eols:
  144.         return dec.replace(CRLF, convert_eols)
  145.     
  146.     return dec
  147.  
  148. body_decode = decode
  149. decodestring = decode
  150.